
FIELD NOTE A WORKING PAPER 



The views, conclusions, and recommendBtions expressed 
herein do not necessarily reflect the official views or poli- 
cies of either the Air rorce or the System Development 
Corporation. 
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Although this working paper contains no classified infor- 
mation it has not been cleared for open publication by the 
Department of Defense. Open publication, wholly or in 
part, is prohibited without prior approval of the System 
Development Corporation. 



(Produced under System Development Corporation sub- 
contract No 202 issued by Intemational Electric 
Corporation in performance of contract AF-30(635)-11583) 
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DOCUMEaHTATIOK OF THE JOVIAL IHTERERETER SYSTEM 

The purpose of this document is to define, describe, and formalize the documentation 
of the JOVIAL Interpreter System. A series of Field Notes will be prepared detailing 
the various phases of the systaa; including components, organization, and operation. 
The docvmentation series will be sequentially numbered and is described below in that 
order. It is expected that the documentation will be released at the same time the 
system, is turned over to the prime contractor. This date is currently scheduled 
as 1 February i960. The concurrent release philosophy has been adopted in an effort 
to minimize the changing and updating of documentation generally inherent in the 
early days of new systems. It is hoped that by holding the documentation imtil 
release of the system, the number of corrections or revisions to the documents will 
be minimized. However, it is planned to update the documentation series as the need 
arises . 

FH-LO-196 — DOCUMEHTATION OF THE JOVIAL IWl'KKFKl^'iiLR SYSTEM 

The present Field Note is intended to be a "cover" document describing 
the purpose, format, and tiseage of the documents for the JOVIAL 
Interpreter System. 

FN-. 10-197 — A IBERS' MANUAL FOR THE JOVIAL INTERPRETER SYSTEM 

The purpose of ttis manual will be an attempt to collect in one 
document the various data required for optimum usage of the JOVIAL 
Interpreter Systaa. It is felt that programmers who ■■•rill be using the 
system will find it more convenient to vse one document containing 
all users' information, rather than having to refer to the individual 
program specif icatioiis. This manual, of necessity, will not include 
the detail shown in the progi-am specification, but will include all 
information necessary for use of the sjrstem. 

FN-LO-198 — C0MH3TER OPERATORS' MANUAL FOR THE JOVIAL INTERPRETER SYSTEM 

The purpose of this document will be to provide the 709 Computer 
operator with infoimation and procedures relating to the operation of 
this system. Detailed description of the printouts that the computer 
uses to communicate with the ccmputer operator, and the course of 
action that he should follow for each printout will be detailed. 
Tape setup and disposition will be explained fully. 

FN-IO-199 — SYSTEM SFECIFICATIOHS FOR THE JOVIAL Dfl'ERPKlifi'KK SYSTEM 

The purpose of this document will be to describe features of the system 
applicable to more than one of the sub-programs. Core allocation, sub- 
program sequence, use of common routines located in permanent core, tape 
assignments, and other data of this natture will be assoabled here. 
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!Hie following group of documents are similar in natijre and have "been designated as 
program design specifications for the variovis sub -programs of the JOVIAL Interpreter 
System. Their format is as follows: 

Introduction 

A prose description of the program's operation outlining its piirpose 
and relation to other sub-programs in the system. 

Environment 

Detailed description of tables, itoas, and ccanmunication registers 
necessary for operation of this program. 

Input 

Description of dynamic input from card or tape. 

Functions 

A listing of the functions included in this program. 

Output 

Tables or items created hy the program and their disposition. 

Printouts 

A detailed listing of printouts and course of action to he followed. 

Flov Diagram 

This would be a broad flow of the program. 

Program Instruction Listing 

The program design specifications will be written in programmer language and will 
set forth the manner in which the ccmputer program fulfills the requirements 
previously set forth. It is felt that the use of a predetermined format is essential 
for optimum usage by those who m^ have to reference various doctahents within 
the set. The following documents will be written in accordance with the above 
format in mind. 

FH-LO-200 — PBOGBAM DESIGN SPECIFICATIOH FOR THE TEST COHTBOL PBOGRAM (JTCPZ) 

PN-LO-201 — PROGBAM DESIGN SPECIFICATIOir FOR THE IHTEBPRETER FIRST PASS (JALLZ) 

FN-LO-202 — PROGRAM DESIGN SPECIFICATION FOR THE ASSEMBLE BABT COMPOOL PROGRAM (JABCZ) 
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FN-LO-203 — PROGRAM DESIGN SPECIFICATION FOB THE DATA SIMULATION PROGRAM (JSTRZ) 

FH-IO-SOif — PROGRAM DBBIGR SPECIFICATION FOR THE INTERPRETER SECOND PASS (JOUZ) 

FN-LO-205 — PROGRAM DESIGN SPECIFICATION FOR THE DATA PROCESSING PROGRAM (JDSYZ) 

FN-LO-206 — PROGRAM DESIGN SPECIFICATION FOR THE ASSMBI£ MASTER COMPOOL PROGRAM (JAMCZ) 

FN-IO-207 — PROGRAM DESIGN SPECIFICATION FOR THE SYSTEM TAPE LOADING PROGRAM (JMSTZ) 

FN-IiO-208 — DISCREPANCY REPORTING AND CORRECTION PROCEDURE FOR THE JOVIAL INTERPRETER 
SYSTEM 

KEP/cah 
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